package com.itheima.dao;

import com.github.pagehelper.Page;
import com.itheima.pojo.Role;
import org.apache.ibatis.annotations.Param;

import java.util.LinkedHashSet;
import java.util.List;
import java.util.Set;

public interface RoleDao {


    /**
     * 根据用户ID查询用户拥有角色
     * @param id    用户ID
     * @return  用户角色信息
     */
    Set<Role> findRolesByUserId(@Param("userId") Integer id);

    /**
     * 查找全部角色信息
     * @return  查找全部角色信息
     */
    List<Role> findAll();

    /**
     * 根据菜单ID查询菜单关联角色
     * @param id    菜单ID
     * @return  菜单关联角色
     */
    Set<Role> findRolesByMenuId(@Param("menuId") int id);

    /**
     * 根据菜单ID查询关联的第一个角色信息
     * @param id    菜单ID
     * @return  第一个角色信息
     */
    Role findRoleByMenuId(@Param("menuId") int id);

    /**
     * 根据角色代码查询角色数量
     * @param role  角色实例
     * @return  角色数量
     */
    Integer findRoleByKeyWord(Role role);

    /**
     * 添加角色
     * @param role 角色实例
     */
    void add(Role role);

    /**
     * 设置菜单与角色的关联关系
     * @param id    角色ID
     * @param menuId   菜单ID
     */
    void setMenuAndRole(@Param("roleId") Integer id, @Param("menuId") Integer menuId);

    /**
     * 设置权限与角色的关联关系
     * @param id    角色ID
     * @param permissionId  权限ID
     */
    void setPermissionAndRole(@Param("roleId") Integer id, @Param("permissionId") Integer permissionId);

    /**
     * 更新角色信息
     * @param role  角色实例
     */
    void update(Role role);

    /**
     * 根据角色ID删除角色与菜单的关联关系
     * @param id    角色ID
     */
    void deleteRoleAndMenu(@Param("roleId") Integer id);

    /**
     * 根据角色ID删除角色与权限的关联关系
     * @param id    角色ID
     */
    void deleteRoleAndPermission(@Param("roleId") Integer id);

    /**
     * 获取角色与用户、菜单、权限关联关系的数量
     * @param id    角色ID
     * @return  关联数量
     */
    int findCountByRoleId(@Param("roleId") int id);

    /**
     * 根据ID删除角色
     * @param id    角色ID
     */
    void delete(@Param("roleId") int id);

    /**
     * 根据ID查询角色信息
     * @param id    角色ID
     * @return  角色实例
     */
    Role findById(@Param("roleId") int id);

    /**
     * 根据ID查询与角色关联的权限ID
     * @param id    角色ID
     * @return  权限ID集合
     */
    Set<Integer> findPermissionIdByRoleId(@Param("roleId") int id);

    /**
     * 根据ID查询与角色关联的菜单ID
     * @param id    角色ID
     * @return  菜单ID集合
     */
    LinkedHashSet<Integer> findMenusIdByRoleId(@Param("roleId") int id);

    /**
     * 分页查询角色信息
     * @param queryString   查询条件
     * @return  分页信息
     */
    Page<Role> findPage(@Param("queryString") String queryString);
}
